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SECTION  I 


GENERAL 


PURPOSE;  The  purpose  of  the  Ammunition  Post  Processor  (APP)  is  to 
compute  ammunition  requirements  predicated  on  the  results  of  modeling  a 
theater  level  conflict.  It  is  further  the  purpose  of  this  APP  User's  Manual  to 
provide  the  combat  analyst  sufficient  information  about  the  background, 
structure  and  organization  of  the  APP  to  effectively  run  it  and  incorporate 
its  results  into  the  study  reports  to  support  the  decision  process. 

The  APP  is  one  of  3  postprocessors  in  the  Wartime  Requirements  for 
Ammunition,  Materiel  and  Personnel  (WARRAMP)  analytical  system 
(methodology).  (Figure  1.1.1)  The  APP  uses  data  produced  by  the  Concepts 
Evaluation  Model  (CEM)  and  the  Combat  Sample  Generator  (COSAGE),  in 
addition  to  data  and  control  information  provided  by  the  combat  analyst. 
The  APP  componets  are  high  lighted  in  the  figure. 

This  user  documentation  includes  ail  component  programs  of  the  APP  with 
general  descriptions  of  structure,  data  base,  UNIVAC  1100  runstream, 
sample  input  data  and  output  data.  Throughout  the  document  specific 
examples  of  runstreams  and  files  are  used.  It  should  be  emphasized  that  the 
user  has  great  flexibility  in  the  naming  conventions  through  modification  of 
the  runstreams  and  the  file  maintenance  capabilities  of  EXEC-8  data  files 
used  in  the  APP.  However,  it  is  recommended  that  the  convention 
established  already  in  the  APP  be  followed.  This  convention  uses  the  basic 
name  of  the  file  as  its  core  and  around  it  is  added  additional  data  which 
distinquish  it  from  other  versions  of  the  file  which  still  may  exist  (for 
example,  the  file  **RPERCK  used  in  the  ESD  program).  The  core  of  the 
name  is  "RPERCK";  the  preceeding  asterisks  are  to  be  replaced  by  the  user's 
computer  identification  number.  Further,  if  the  user  has  more  than  one 
version  of  the  **RPERCK  file  he  can  distinquish  the  version  by  appending 
the  date  of  creation  to  each  element;  for  example,  **PRERCK/18Jul80. 
These  procedures  assist  the  user  in  maintaining  a  data  audit  trail  for 
verification  and  study  reports. 

This  document  has  been  prepared  under  the  assumption  that  users  of  the 
APP  have  a  working  understanding  of  the  UNIVAC  EXEC  8  operating 
system,  it's  functions,  and  the  system  Editor  capabilities. 

APPLICATION;  The  Ammunition  Post  Processor  is  designed  to  support  the 
analysis  of  ammunition  requirements  as  a  part  of  WARRAMP  methodology. 
Other  applications  may  be  developed  based  upon  a  user's  study  of  the 
component  programs  and  determining  applicability. 

SECURITY  and  PRIVACY:  The  individual  software  components  (programs) 
are  cataloged  as  indicated  under  the  detailed  descriptions  for  each 
program.  In  each  case,  they  are  cataloged  in  the  public  mode  for  user 
access.  User's  are  asked  not  to  modify  or  edit  (write)  in  the  program  files. 
In  the  event  alteration  is  required  for  a  specific  purpose,  a  potential  user 


should  copy  the  program  to  a  file  under  his/her  user  identification,  and  then 
edit  the  file  as  desired.  In  event  of  error  detection  during  use,  the  user  is 
requested  to  note  the  error  by  program  line  and  forward  the  proposed 
correction  to  the  program  custodian,  so  that  the  record  program  may  be 
updated.  Test  (sample)  data,  either  input  or  output,  and  the  programs 
contained  herein  are  unclassified.  User's  must  apply  the  appropriate 
security  classifications  to  their  data  files  and  are  responsible  for  the 
safeguard  of  printed  matter  accordingly  in  accordance  with  USACAA  policy. 

CONFIGURATION:  Figure  1.1.1  depicts  the  overall  WARRAMP  system  and 
methodology.  The  portion  of  the  system  which  this  document  covers  is 
contained  in  the  heavy  lined  boxes.  The  details  of  the  APP  configuration  is 
discussed  in  the  following  section. 

REFERENCES:  Project  references  can  be  found  in  Appendix  A.  This 
documentation  effort  was  achieved  through  contractor  support  to  USACAA, 
by  CACI,  Inc.,  under  contract  MDA903-80-D-0668.  The  Contracting 
Officers  Technical  Representative  (COTR)  was  Mr.  Hugh  3ones,  Models 
Group,  Methodology  and  computer  Support  Directorate,  USACAA.  This 
manual  is  one  of  a  series  to  document  the  WARRAMP  Methodology's 
computer  software.  Volume  IV  of  the  series  contains  the  Program 
Maintenance  portion  of  the  instructions  on  this  software. 

TERMS  and  ABBREVIATIONS:  Terms  and  abbreviations  are  used 
throughout  to  facilitate  communications  of  sets  of  words  (acronyms)  and 
analytical  expressions  common  to  the  methodology  and  military  operations 
research.  A  complete  listing  may  be  found  in  Appendix  B  of  this  manual.  In 
addition,  to  the  full  statement  of  the  expression  followed  by  the  acronym  or 
term  in  closed  parenthesis  is  used  throughout  the  manual  on  the  first 
occurence  of  its  use. 


WARRAMP  OVERVIEW 


Figure  1.4.1 
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SECTION  II 


SYSTEM  SUMMARY 


1. 


GENERAL  DESCRIPTION:  Figure  II.  1.1  depicts  the  overall  structure  and 
flow  of  the  normal  execution  of  the  Ammunition  Postprocessor  and  the  order 


in  which  the  individual  routines  are  executed.  As  can  be  seen  from  the  flow, 
the  major  source  of  the  data  used  by  the  APP  is  supplied  by  the  CEM  ana 
COSAGE  Models.  The  major  purpose  of  the  APP  is  to  continue  the 
processing  and  reformatting  of  data  produced  by  these  systems  into  the  final 
reports  which  detail  for  combat  analysts  and  decision  makers  the 
ammunition  requirements  that  are  expected  to  be  generated  by  a  theater 
level  conflict  of  campaign  (180  days)  duration. 


Another  aspect  of  the  APP  structure  is  presented  in  Figure  11.1.2,  the  APP 
Input/Output  Summary.  This  chart  organizes  files  and  programs  used  in  the 
APP  in  an  effort  to  identify  all  programs  and  files  which  make  up  the  APP. 
In  addition  it  denotes  the  files  as  required  as  input  by  specific  programs  and 
which  files  are  produced  as  output  by  each  program. 

The  output  from  the  Concepts  Evaluation  Model  defines  weapon  system 
activity  level  and  attrition  for  a  theater  level,  campaign  long,  period  of 
combat;  the  Combat  Sample  Generator  provides  the  high  resolution  combat 
(24  hours)  results. 


1.1  DATA  REQUIREMENTS:  The  overview  of  the  data,  by  functional 
description  is  as  follows: 

o  Combat  Sample  Generator  provides  to  the  Ammunition  Buffer  program: 
—blue  weapon  system  data: 
oo  munition  characteristics. 

oo  stylized  quantities  of  engaged  blue  equipment  by  type  for  24-hour 
combat  by  posture. 

oo  stylized  ammunition  expenditures  for  24-hour  combat  by  posture, 
red  weapon  system  data: 

oo  stylized  loss  of  red  equipment  by  type  to  blue  equipment  by  type 
for  24-hour  combat  by  posture 

o  Combat  Sample  Generator  Provides  to  CEM: 

—  Killer-Victim  scoreboards  by  posture. 

—  ammunition  expenditures  (rounds,  tonnage)  by  posture. 

o  CEM  provides  to  the  Ammunition  Buffer  program: 

—  blue  weapon  data,  daily: 

oo  deployment  data. 

oo  in  -  theater  replacements, 

oo  repair/returned  to  duty, 

oo  replacements  from  pool, 

oo  replacements  to  pool  from  higher  level, 

oo  surviving  assets. 


—  blue  weapon  data,  daily,  by  combat  (engagement  type)  posture: 

oo  quantity  engaged  by  red. 

oo  "K"  or  catastrophic  kills, 

oo  "M"  or  mobility  only  kills. 

—  red  Weapon  data,  daily,  by  type  of  equipment  and  combat 
(engagement  type)  posture: 

oo  quantity  engaged  by  blue, 

oo  quantity  hit  by  blue. 

The  weapon  systems  analyzed  in  the  APP  is  driven  by  those  simulated  and 
modeled  in  the  high  resolution  model  and  the  theater  model;  those  in  turn, 
are  driven  by  the  force  being  analyzed  within  a  specified  out  year,  i.e., 
fiscal  year  1987,  1988,  etc. 

2.  POSTPROCESSOR  ORGANIZATION:  The  study  flow  is  initiated  by  the 
preparation  and  application  of  two  primary  simulations:  CEM  and 

COSAGE.  The  CORK  program  in  utilized  to  prepare  COSAGE  output  for 
input  to  CEM.  When  the  COSAGE  output  is  completed,  the  analyst  may 
begin  preparing  the  selected  COSAGE  output  data  for  subsequent  use  by  the 
APP;  once  the  CEM  output  is  available  to  the  analyst,  he  can  begin  to 
sequentially  execute  the  Ammunition  Buffer  Program,  the  Equivalent 
Stylized  Day  program,  and  finally,  the  Report  Generator  Program. 

2.1  SYSTEM  FLOW:  The  system  flow  is  a  depicted  in  the  graphics  that  follow 
(Figure  ll.I.l).  The  Ammunition  Buffer  program  establishes  the  dataset  for 
expenditures  equivalencing  and  mapping  equipment  types,  and  sample  data 
from  the  CEM.  The  Equivalent  Stylized  Day  program  computes  the  ESD 
values  given  the  buffered  expenditures  from  CEM  and  the  stylized  loss  data 
from  COSAGE.  The  Report  Generator  completes  the  rates  computations 
and  writes  out  the  computed  values. 

2.2  SYSTEM  PARAMETERS:  The  methodology  follows  several  military 

analytical  concepts  that  are  best  expressed  as  parameters  to  the  modeling 
effort,  and  subsequently  flow  into  the  ammunition  post  processor 
application.  These  are  summarized  below: 

Military  Equipment  Categories:  Equipments  are  grouped  into  categories 
based  upon  such  military  characteristics  as  vulnerability,  mobility, 
armor,  armament  and  mission.  By  grouping  equipment  types  into  such 
categories,  aggregation  of  data  occurs  which  is  beneficial  in  analysis, 
when  there  is  no  significant  difference  in  system  behaviour  on  a 
hypothetical  battlefield.  Categories  employed  in  this  software  are: 

1  =  personnel 

2  =  tanks 

3  =  light  armored  vehicles  (APC's) 

4  =  helicopters 

5  =  anti-tank  and  mortor  weapons 

6  =  artillery  weapons  systems 
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Equipment  types:  Military  equipment  types  are  associated  with  specific 
combat  weapon  systems.  The  quantities  of  equipment  types  represented 
are  limited  generally  by  the  modeling  (software)  effort  and  their 
relative  significance  (analytically)  on  the  hypothetical  battlefield.  Each 
equipment  type  belongs  to  a  common  set  or  category  as  discussed 
above.  The  upper  limits  on  the  number  of  equipment  types  per 
category,  and  examples  are  as  follows  (each  force  has  the  same  quantity 
of  equipment  types): 


Personnel 

1  type 

Tanks 

12  types 

M  -  48 

M  -  60 

M  -  1 

A  PC's 

12  types 

M  -  113 

M  -  114 

Helicopters 

5  types 

AH  -  1G 

AH  -  IS 

AH  -  64 

A/T  -  Mortors  — 

8  types 

4.2  inch  mortor 
81  mm  mortor 
DRAGON 

TOW 

Artillery 

12  types 

105  Howitzer 

1 55  SP  howitzer 
8  inch  howitzer 

The  user  should  be  aware  that  "equipment  types"  is  occasionally  used  as 
a  synonym  to  "weapon  system"  or  "weapon"  in  the  methodology. 

Combat  Engagement  Types:  Military  analysis  has  developed  methods  of 
expressing  the  traditional  force  to  force  activity  on  the  battlefield 
based  upon  one  force's  mission.  For  analysis,  in  this  methodology,  there 
are  8  significant  types  of  engagements. 

1  =  blue  attacking  a  red  delaying  force. 

2  =  blue  attacking  a  red  force  in  prepared  defenses. 

3  =  blue  attacking  a  red  force  in  a  hasty  defense. 

4  =  blue  -  red  meeting  engagement. 

5  =  red  attacking  a  blue  force  in  a  hasty  defense. 

6  =  red  attacking  a  blue  force  in  a  prepared  defense. 

7  =  red  attacking  a  blue  delaying  force. 

8  =  red  and  blue,  inactive  or  static;  may  be  called  defense 

light. 

An  engagement  type  is  also  referred  to  as  a  posture  which  alludes  to  the 


7 


t  v: 


quantity  of  each  force  involved,  or  force  ratio.  In  the  analysis  of 
requirements  in  the  WARRAMP  methodology  these  engagement  types 
are  equivalent  to  CEM  sample  data. 

Theater  Cycle:  A  basic  period  of  theater  combat  modeled  in  CEM  is 
four  days,  hence  a  theater  cycle  is  of  four  (modeled)  days  duration  and 
there  are  45  cycles  in  the  campaign  (180  -  day  war).  Typically  the 
intensity  of  combat  increases  and  decreases  throughout  the  war.  Initial 
deployments  are  attritted,  followed  by  resupply  and  additional 
deployments  of  reserve  forces;  each  theater  cycle  is  unique  and 
provides  data  representative  of  the  modeled  force  in  combat  for  the 
particular  period  of  time. 

Stylized  Force:  A  stylized  force  for  analytical  purposes  under  the 
WARRAMP  methodology  is  a  blue  and  red  force  portrayed  (in  a  data 
set)  with  representative  types  of  equipment,  munitions  and  personnel 
levels.  It  may  be  a  composite  force  or  organization  that  would  not  exist 
in  reality;  the  purpose  is  to  model  and  simulate  the  battlefield  dynamics 
of  these  componets  to  gather  results  useful  in  analysis. 

Combat  Sample;  A  combat  sample  is  the  outcome  (output  or  results)  of 
a  blue  and  red  force  arrayed  on  the  battlefield,  engaged  in  combat,  and 
is  normally  produced  with  a  high-resolution  model  that  simulates  the 
aspects  of  warfare  in  detail.  The  forces  are  so  composed  (by  data  input 
to  the  model)  to  portray  each  type  of  blue  and  red  equipment  and 
munition  of  analytical  interest.  A  combat  sample  is  typically  results  of 
warfare  simulated  for  one  day  (24  hours)  with  a  stylized  force  array. 

Combat  Sample  Set:  A  combat  sample  set  is  typically  composed  of  four 
combat  samples,  as  described  above.  Each  sample  is  the  results  of  a 
simulation  run,  and  a  sample  type  is  designated  by  the  combat  activity 
of  the  blue  force.  The  four  types  typically  used  are  attack  (AT),  delay 
(DE),  defense  intense  (01)  and  defense  light  (DL).  The  combat  sample 
set  has  one  sample  of  each  type  of  combat  activity.  The  production  of 
each  sample  type  requires  different  force  compositions  and  different 
force  arrays,  also  called  postures,  because  the  force  is  postured 
(initially  in  the  simulation)  to  attack,  delay,  or  defend  (intense,  and 
light  or  static.) 

Combat  Slice:  The  use  of  the  analytical  sector  called  "combat  slice"  is 
drawn  from  the  low  -  resolution  theater  level  model  and  typically  the 
red  array  formed  by  deployed  red  unit  assets.  A  combat  slice  is  usually 
identified  by  the  engagement  types  and  is  refered  to  as  a  CEM  Sample. 

Equivalent  Stylized  Day:  The  blue  force  expenditures  which  occur  in 
each  combat  or  force  slice  are  expressed  in  equivalent  stylized  days.  A 
day  oi  combat,  within  the  theater  model,  with  a  combat  slice  is 
equivalenced  to  the  stylized  day  (by  posture  or  type)  as  represented  by  a 
combat  sample  discussed  above.  The  E5D  is  an  analytical  method  to 
express  the  experience  (in  expenditures  or  loss)  of  blue  equipment  items 
or  munitions  overtime,  by  posture  in  the  theater.  Therefore,  each  blue 
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munitions  or  equipment  of  analytical  interest  will  have  an  ESD.  In  the 
current  methodology  up  to  40  ESD's  are  computed.  The  ESD 
computations  utilize  ratios  expressed  as  the  "actual"red  equipment 
types  lost  to  blue  equipment  types  over  "stylized"  red  equipment  types 
lost  to  blue  equipment  types.  The  user  should  refer  to  a  recent  study 
report  for  a  complete  discussion  of  ESD  computations  methodology,  or 
item  Z  of  Appendix  A,  references. 
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SECTION  III 


CHAPTER  1 

AMMUNITION  BUFFER  PROGRAM 


1.1  DESCRIPTION:  The  Ammunition  Buffer  Program  of  the  Ammunition 

Postprocessor  (APP)  has  three  purposes.  The  first  purpose  is  to  allow  the 
combat  analyst  to  enter  control  and  mapping  information  to  the  system 
which  describes  the  environment  in  which  the  APP  is  operating  and  directs 
its  execution.  The  second  purpose  is  to  identify,  select  and  format, 
logistics,  and  combat  loss  data  produced  by  the  Concepts  Evaluation  Model 
(CEM).  This  data  will  be  used  as  input  to  the  remaining  programs  of  the 
APP.  A  key  computation  is  Loss  due  to  Permanent  Kill  (LOSTPK)  ratio. 
This  value  is  computed  from  the  input  LOGREP  data  and  then  is  employed  to 
factor  (partition)  the  "hit"  data  into  K  -  kill  and  M  -  kill  quantities. 

LOSTPK  (Equipment  Type,  Category,  Side,  Theater  Cycle)  = 

_ _  Permanent  Loss _ 

Total  Loss  +  Permanent  Loss 

The  LOSTPK  value  is  used  to  compute  losses  for  direct  fire  systems  only. 
Artillery,  or  indirect  fire  loss  quantities  are  computed  as: 

Artillery  K  -  kills  =  0.02 

x  Surviving  quantity  artillery 
x  Ratio  personnel  engaged 

Artillery  M  -  kills  are  computed  by  the  same  formula.  The  quantity  of 
artillery  engaged  for  each  side  is  computed  as: 

Artillery  Engaged  =  2.0 

x  Surviving  quantity  artillery 
x  Ratio  personnel  engaged 

The  third  purpose  is  to  allow  the  analyst  to  directly  enter  equipment  and 
personnel  quantity  data  which  is  also  used  as  input  by  the  following  programs 
of  the  APP. 

The  Ammunition  Buffer  produces  two  output  files.  One  is  a  list  of  error 
conditions  detected  by  the  buffer,  the  other  is  the  data  file  that  is  used  as 
input  by  the  following  programs  of  the  APP. 

The  program  is  written  in  the  FORTRAN  IV  programming  language. 

1.2  STRUCTURE:  Figure  III.  1.1  displays  the  overall  structure  of  this  utility 
which  identifies  the  input  files  required  and  the  output  files  produced.  The 
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number  on  the  upper  left  of  each  flow  chart  symbol  denotes  the  logical  unit 
used  in  the  runstream.  The  internal  number  denotes  the  sequence  that  input 
files  are  called  by  the  program. 

1.3  DATA  BASE:  The  data  base  which  is  used  to  support  this  process  consists 
of  five  input  files  and  one  output  file.  These  files  are  not  part  of  a  formal 
database  or  data  management  system.  Three  of  the  input  files,  the 
LOGREP,  LOSSREP,  and  AMMOl  are  produced  for  the  APP  by  the  Concepts 
Evaluation  Model  (CEM);  the  remaining  two  files,  TRMAPS  and  TRCONS, 
are  maintained  by  the  combat  analyst.  The  files  are  processed  sequentially, 
and  normally  reside  on  mass  storage  devices,  within  files  permanently 
cataloged  by  the  current  APP  combat  analyst. 

1.4  RUNSTREAM:  Figure  111.1.2  depicts  the  runstream  which  is  typically  used 
to  control  the  execution  of  the  APP.  The  runstream  is  cataloged  on  the 
system  as  a  "START"  file  (element)  and  is  normally  submitted  as  a  batch  run 
to  the  system  from  a  terminal.  The  input  data  files  must  be  prepared  in 
advance  of  run  submission.  In  accordance  with  USACAA  security  policy, 
these  files  are  classified  and  access  is  controlled  through  read  and  write 
keys.  The  following  functions  are  accomplished: 


o  The  run  is  activated  and  run  information  supplied  to  the  system. 

o  The  input  files  from  CEM  are  identified  and  assigned  to  appropriate 
devices. 

o  Through  the  system  editor,  via  the  @ED  command,  the  user-maintained 
files  TRMAPS  and  TRCONS  are  assigned  to  the  appropriate  logical 
unit.  In  the  example  it  can  be  seen  that  the  user  further  specified 
particular  versions  or  elements  of  these  files.  For  example  the  V 
version  of  the  TRCONS  file  will  be  used  in  this  example  run. 

o  Two  temporary  files  are  assigned  to  be  used  to  hold  output  from  the 
APP. 

o  The  RUNREC  file  is  assigned,  labeled  and  breakpointed  to  hold  run 
output. 

o  The  APP  (called  CEMTRBUF)  object  code  is  executed  via  the  (dXQT 
command. 

o  The  breakpoint  (output  file)  is  closed. 

o  Throng'  i'e  system  editor,  the  first  40  and  last  20  lines  of  the  37T 
output  file  are  printed  onto  the  user's  run  output  (PR1NT$)  file. 

o  Applying  the  system  editor,  the  output  file,  **AMMOIN  is  transformed 
from  temporary  storage  to  permanent  storage  and  the  first  25  lines  are 
printed  out  for  verification  onto  the  user's  run  output  (PRINT$)  file. 
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1.5  INPUT.  The  Ammo  Buffer  requires  five  input  files.  As  noted  earlier,  three 
of  these  files  are  produced  by  CEM  and  require  no  further  maintenance  by 
the  combat  analyst.  These  files  are  the  LOGREP,  LOSSREP,  and  AMMOl. 
The  first  two  of  these  are  designed  and  labeled  so  that  if  printed  out  they 
are  self  explanatory  and  readable  by  analyst.  Examples  of  these  reports  can 
be  found  in  Figures  III.  1.3,  III.  1.4  and  III.  1.5,  respectively. 

o  The  CEM  logistics  report  (LOGREP)  has  several  components  and  not 
all  logistics  data  is  used  by  this  program.  The  LOGREP  components 
are  (1)  The  Force  Theaterwide  Logistic  Summary,  and  (2)  The  Force 
Logistic  Experience  by  major  item  type.  The  CEM  logistics  report 
reader  portion  of  this  program  performs  a  record  by  record  check  of 
the  data  file  looking  for  keywords  located  in  specific  positions  in  the 
logistics  report.  Once  the  tests  are  satisfied,  the  program  extracts  the 
specific  data  required  by  the  program.  Only  the  force  theater  wide 
logistic  summary  and  the  force  logistic  experience  by  major  item  type 
summaries  are  used.  The  first  two  pages  of  Figure  III.  1.3  show  samples 
of  the  theaterwide  logistic  summary,  and  the  last  two  pages  of  Figure 
III.  1.3  shows  samples  of  the  logistics  experience  by  major  item  type. 

o  The  LOSSREP  file  is  labeled  and  captioned  as  the  Dailey  Combat 
Damaged  (PERM  +  TEMP)  vs  Cause  Table.  The  LOSSREP  components 
are  :  daily  reports  for  each  side,  with  each  days  loss  report  being 
partioned  into  a  TOTAL  section,  PART  1,  PART  2,  and  PART  3.  The 
LOSSREP  reader  portion  of  the  program  performs  a  record  by  record 
check  of  the  data  (LOSSREP)  file  looking  for  specific  keywords  located 
in  specific  positions  in  the  report.  Once  the  key  word  tests  are 
satisfied,  the  program  extracts  the  specific  data  required.  Figure 
III.  1.4  provides  a  sample  of  the  data  file.  The  printed  labels  provide 
explanations  for  the  report. 

o  The  AMMOl  input  file  provides  (from  CEM)  the  numbers  of  equipment 
engaged  and  hit  for  each  of  the  6  equipment  categories,  by  equip  . i*'*'*'. 
type.  The  file  is  unlabeled,  with  exception  to  the  first  record  whicn 
provides  a  title  and  separates  each  day's  data.  Thus  there  are 
approximately  193  records  of  data  for  each  day's  activity.  This  file 
provides  only  "hit"  data  and  "engaged"  data;  the  program  computes  the 
quantity  that  is  "K  -  kill"  and  M  -  kill"  using  the  LOSTPK  value  for  the 
equipment  type,  category,  side  and  theater  cycle.  Figure  III.  1.5 
presents  an  example  of  the  input  data.  . 

In  the  data  file  a  block  of  six  (category)  constitutes  data  for  one  side, 
either  engaged  or  hit,  for  one  engagement  type.  For  example,  records 
2  through  7  are  the  quantities  of  engaged  equipment  for  the  blue  force 
in  engagement  type  1  (blue  attacking  red  delaying  force).  Records  8 
through  13  are  the  quantities  of  equipment  hit  for  the  blue  force  in 
engagement  type  1. 

FILE:  AMMOl 

STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  Output  from  CEM 


RECORD  LAYOUT: 


POSITION 


DESCRIPTION 


FORMAT 


1-9 


1-108 


1-108 


1-45 


1-108 


1-72 


-RECORD  1- 
Header  label  for  day 

-RECORD  2- 

Personnel  Engaged  in  blue  force  in 
engagement  type  1. 

-RECORD  3- 

For  each  of  the  twelve  blue  tanks 
(category  2),  the  quantity  engaged, 
sequentially  from  left  to  right  by 
equipment  type  (CEM  weapon  number),  in 
engagement  type  1. 

-RECORD  4- 

For  each  of  the  twelve  blue  APC's 
(category  3),  the  quantity  engaged, 
sequentially  from  left  to  right  by 
equipment  type  in  equipment  type  1. 

-RECORD  5- 

For  each  of  the  five  blue  helicopters 
(category  4),  the  quantity  engaged, 
sequentially  from  left  to  right  by 
equipment  type  in  engagement  type  1. 

-RECORD  6- 

For  each  of  the  twelve  blue  anti-tank 
or  mortors  (category  5),  the  quantity 
engaged,  sequentially  from  left  to  right 
by  equipment  type  in  engagement  type  1. 

-RECORD  7- 

For  each  of  the  eight  blue  artillery 
(category  6)  pieces,  tlv  quantity  engaged, 
sequentially  from  left  to  right  by 
equipment  type  in  engagement  type  1. 


Alpha 

F9.1 

12F9.1 

12F9.1 

5F9.1 

12F9.1 

8F9.1 
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-RECORDS  8  -  13- 


Data  as  above,  except  the  values  are 
the  quantity  hit. 


-RECORDS  14-  19- 

Data  as  above  in  records  2-7,  only  for 
the  red  side. 


-RECORDS  20  -  25- 

Data  as  above  in  records  8-13,  only 
for  the  red  side. 


-RECORDS  26  -  49- 

Data  as  above  in  records  2  -  25,  only 
for  engagement  type  2  (blue  attacking 
red  prepared  defense). 

-RECORDS  50  -  73- 

Data  as  above  in  records  2  -  25,  only 
for  engagement  type  3  (blue  attacking 
red  hasty  defense). 

The  remaining  two  files  used  by  the  Ammo  Buffer  are  the  TRCONS  and 
TRMAPS  files.  Unlike  the  three  files  produced  by  the  CEM,  these  two  files 
are  maintained  by  and  are  under  the  control  of  the  combat  analyst.  The 
files  are  used  by  the  Ammo  Buffer  to  identify  the  combatants  and  the  type 
and  quantity  weapons  being  considered  in  this  particular  analysis  and  to 
describe  the  general  environment  that  the  battle  is  being  fought.  While  any 
portion  of  these  files  may  be  modified  by  the  analyst  for  a  particular  study, 
normally  very  little  change  is  required  from  study  to  study.  The  analyst 
would  use  the  on-line  system  editor  in  the  demand  mode  (terminal)  to  modify 
and  maintain  the  files. 

o  TRMAPS  input  data  file  -  The  file  layout  and  description  of  the  data 
found  in  the  TRMAPS  file  is  as  follows.  The  sample  data  is  shown  in 
Figure  III.  1.6.  The  "TRMAPS"  label  is  a  carry-over  from  the 
methodology  when  the  Theater  Rates  model  (hence  the  "TR")  was  used; 
the  data  is  "mapping"  or  equivalencing  data  for  the  methodology. 

FILE  :**TRMAPS 

STORAGE  MEDIUM  :  MASS  STORAGE 

SOURCE  :  Manually  developed  and  maintained  using  the  system  editor. 
RECORD  LAYOUT 
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POSITION 


DESCRIPTION 


FIELD  FORMAT 


1-3 


1-24 


1-36 


-RECORD  1- 


Maximum  number  of  Theater  cycles 

-RECORD  2- 

lst  Data  Array  Defining  Alpha- 
numerics.  There  will  be  6  variable 
labels  defining  weapon  categories. 

These  values  must  be  consistant  with 
the  CEM  LOGREP  labels  as  they  are  used 
in  scanning  the  file. 

-RECORD  3- 


2nd  Data  Array  Defining  Alpha- 
numerics.  There  will  be  6  variable 
labels  defining  weapon  categories. 
These  values  must  be  consistant  with 
the  CEM  LOGREP  labels  as  they  are 
used  in  scanning  the  file. 


PERSNL 

TANK 

APC 

HELO 

AT/M 

ARTY 


Military  personnel 
Tank 

Armored  Personnel  Carrier 
Helicopter,  attack 
Anti-tank,  mortor  weapons 
Indirect  Fire  (Artillery)  System 


-RECORD  4,  5,  6,  7- 


1-66  3rd  Data  Array  Defining  Alpha-constant 
numerics.  These  values,  presented  as 
integer,  are  used  in  reading  the  CEM 
LOGREP  and  are  set  to  alphanumeric  for 
logic  tests  in  scanning  the  data  (LOGREP) 
file.  They  are  the  theater  cycle  numbers  to 
be  analyzed. 

-RECORD  8- 

1-18  Number  (maximum)  of  possible  weapons  types 
in  each  of  the  6  CEMH/L  categories 
for  the  1st  side  of  the  battle 


I  3 

6  (A4) 

6(A6) 


1 1(A6> 

6(13) 
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-RECORD  9- 


1-18  Number  (maximum)  of  weapon  types  in  each  6(13) 

of  the  6  CEMH/L  categories  for  the 
2nd  side  of  the  battle 

-RECORD  10-15- 

1-60  Playing  status  of  each  blue  weapon  system  20(13) 

1  record  for  each  category: 

1  =  Played  or  modeled 
0  =  Not  Played  or  modeled 

-RECORD  16-21- 

1-60  Playing  status  of  each  red  weapon  system,  I  3 

are  record  for  each  category: 

1  =  Modeled 
0  =  Not  Modeled 

If  the  system  is  of  category  3,  then, 

1  =  Red  A  PC 
9  =  Red  ICV 

-RECORD  22- 

Free  Five  data  values  in  order:  I 

Format  Max  number  of  weapons, 

(equipment),  blue 
Max  number  of  weapons 
(equipment),  red 
Number  of  samples 
Number  of  equivalent 
stylized  days 

Number  of  Engagement  types 

-RECORD  23-2 4- 

Free  Blue  CEM  mapping  numbers,  these  1 

Format  are  positioned  by  order;  the  quantity 

must  equal  the  number  input  on  record  22. 

-RECORD  25-26- 

Free  Red  CEM  mapping  numbers;  these  are  I 

Format  positioned  by  order;  the  quantity  must 
equal  the  number  input  or  record  22. 

-RECORD  27- 

Free  Red  AMMO  mapping  numbers,  these  are  I 

Format  positional  and  the  quantity  must  equal 
the  number  input  on  record  22. 
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o  »*TRCONS  file  denotes  the  stylized  quantity  (in  the  case  of  personnel, 
the  number  of  troops)  of  each  item  of  CEM  equipment  that  will  be 
played  in  each  of  the  four  combat  postures  of  the  study  (for  each  of  the 
items  that  are  being  played  as  identified  in  the  TRMAPS  file).  This  file 
is  also  a  cairyover  from  the  period  when  the  Theater  Rates  model  was 
used,  hence  the  "TR";  the  data  contained  is  the  controlling  data.  The 
program  reads  this  file  using  the  free  format  option  of  FORTRAN. 
Thus  there  is  no  rigid  formating  scheme  that  must  be  followed  with  the 
exception  of  separating  each  entry  by  a  space.  However,  in  the  interest 
of  consistency  and  organization  it  can  be  seen  from  the  data  example  in 
Figure  III.  1.7  that  the  quantity  data  for  each  item  of  equipment  and  its 
four  postures  is  detailed  on  a  separate  line  and  each  new  item  receives 
a  new  line.  The  TRMAP  identified,  on  records  23  and  24,  15  CEM 
weapon  (equipment),  thus  there  are  15  records,  as  for  each  in  this  file. 

1.6  OUTPUT:  The  Ammo  Buffer  utility  produces  two  output  files.  The  first  is 
the  Run  Record  Report  (**RUNREC).  It  is  produced  on  Unit  6  (PR1NT$)  of 
the  system,  and  is  a  report  which  tracks  the  execution  of  the  utility  and 
provides  the  analyst  a  summary  of  some  of  the  major  events  of  the 
execution  of  the  utility.  A  sample  of  the  output  is  provided  in  Figure 
111.1.8.  A  general  description  of  format  is  as  follows: 

F1LE:**RUNREC 

STORAGE  MEDIUM:  Mass  Storage  -  disk  resident 

SOURCE:  The  PRINT$  output  from  the  program  execution  of  the 
AMMUNITION  BUFFER  program;  a  breakpointed  file. 

POSITION  DESCRIPTION  FIELD  FORMAT 

-RECORD  1- 

Execution  statement 

-RECORD  2- 

Heading  label  written  from  program 
-RECORD  3- 

First  Type  (weapon)  counter  Free  Format-1 

Second  Weapon  category  Free  Format-I 

1  =  Personnel 

2  =  Tanks 

3  =  Light  Armor 

4  =  Helicopters 

5  =  Anti-tank  and  Mortors 

6  =  Artillery 

Third  The  side  or  force  to  whom  the  assets  Free  Format-I 

belong 


1  =  Blue 

2  =  Red 


-RECORD  4- 


1-5 

Theatre  cycle  number  value  from 

1  to  45 

1  5 

6-16 

Quantity  of  the  major  item 
type  authorized 

F  10.0 

17-26 

Quantity  of  the  major  item 
type  on  hand 

F  10.0 

27-33 

The  percent  of  the  major  item 
type  on  hand 

F  7.0 

34-95 

The  major  item  type  data  in 

12  (F8.0) 

order  for  the  cycle: 

1  -  Quantity  resupply  to  theater  stocks 

2  -  Quantity  repaired 

3  -  Total  Gains 

4  -  Theatre  stock  at  end  of  cycle 

5  -  Quantity  in  repair  at  end  of  cycle 

6  -  Temporary  cycle  combat  losses  (to  repair) 

7  -  Permanent  losses 

&  -  Total  combat  losses 

9  -  Temporary  non-combat  losses 

10  -  Permanent  (non  combat)  losses 

1 1  -  Sum  of  all  losses  (Perm  +  Temp) 

12  -  Total  Temporary  losses 

-RECORD  5,  6- 

Repeat  of  format  described  above 
in  records  3  and  4  for  theater  cycle  2 

-RECORDS  7  -  92- 

Repeat  of  above  format  for  5  and  6, 

2  records  for  each  theater  cycle. 

-RECORDS  93  -  EOF- 

The  volume  of  data  prohibits  a  detailed 
discussion,  but  the  sequence  tracks  the 
execution  of  the  program.  An  examination  of 
the  program  code  is  necessary  if  the  user 
desires  a  detailed  examination. 
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The  second  output  file,  **AMMOIN,  is  the  major  product  of  the  utility.  This 
file  will  contain  the  control  information  provided  by  the  user  in  addition  to 
the  logistic,  loss  and  ammunition  data  selected  by  the  combat  analyst  and 
provided  by  the  Combat  Evaluation  Model  (CEM).  This  file  is  formated  for 
use  in  the  following  programs  of  the  APP  and  not  to  be  immediately  read  by 
the  combat  analyst.  A  record  layout  of  the  file  is  as  follows  and  an  example 
of  the  data  is  provided  in  Figure  111.1.9. 

The  order  of  output  to  the  file  is  (in  column)  1)  deployments,  2) 
replacements  to  resource  pools  for  distribution,  3),  return  to  duty  (to  the 
unit)  from  direct  support  (DS)  maintenance,  4)  return  to  resource  pool  from 
general  support  (GS)  maintenance,  5)  replacement  to  theater  stock  plus  GS 
maintenance  returns  to  pool  or  stock  and  6)  surviving  assets.  The  records 
are  formated  as  follows: 

FILE:  **AMMOIN 

STORAGE  MEDIUM:  Mass  storage  -  disk  resident;  a  program  file  in  SDF 
cataloged  by  the  analysts. 

SOURCE:  Output  created  by  the  execution  of  the  Ammo  Buffer  program. 
POSITION  DESCRIPTION  FIELD  FORMAT 


-RECORD  1- 


First 

Total  of  red  and  blue  weapon 
system  types  modeled 

Free-1 

Second 

The  number  of  modeled  categories 

Free-I 

Third 

The  number  of  combat  samples 
represented  in  the  data 

Free-I 

Fourth 

The  number  of  equivalent  stylized 
days  modeled 

Free-I 

Fifth 

The  number  of  engagement  types 
modeled  or  CEM  samples. 

Fres-1 

-RECORD  2- 

First- 

sixth 

The  maximum  quantity  of  weapon 
systems  in  each  category 
for  the  blue  force 

Free-I 

-RECORD  3- 

First- 

sixth 

The  maximum  quantity  of  weapon 
systems  in  each  category  for 
the  red  force 

Free-1 
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-RECORD  4-9- 


First- 

sixth 

The  CEM  mapping  numbers  for  each  of 
the  30  blue  force  systems  modeled; 

99  denotes  that  the  system  is  not 
accounted  for  in  this  processing 

Free-I 

-RECORD  10-11- 

First- 

third 

The  CEM  mapping  numbers  for  red 
weapon  systems 

Free-I 

-RECORD  12- 

First- 

sixth 

The  Ammo  Rates  mapping  numbers 
for  red  weapon  systems 

Free-1 

-RECORD  13-28- 

First- 

fourth 

Each  record  contains  stylized  quantity 
data  for  one  blue  weapon  system  per 
sample  (example  is  4),  the  16  records 
represent  the  16  CEM  weapons 

Free-I 

-RECORD  29- 

First 

The  total  number  of  days;  which  is 
the  number  of  theater  cycles  (45) 
times  the  number  of  days  per  cycle  (4). 

Free-I 

-RECORD  30- 

First 

Deployment  quantity-blue 
-  category  1 
(only  one  type  in  cat  1) 

Free-F 

Second 

Replacements  to  pool-blue 
-  category  1 

Free-F 

Third 

Return  to  duty-blue 
-  category  1 

Free-F 

Fourth 

Return  to  pool-blue 
-  category  1 

Free-F 

Fifth 

Replacement  to  stock-blue 
-  category  1 

Free-F 

Sixth 

Surviving  Assets  -  blue 

Free-F 

category  1 


-RECORD  31-32- 


Blank 

-RECORD  33-34- 

These  twelve  records  have  data 
for  the  6  deployment  status  (columns) 
for  the  Category  2  weapon  items  (tanks); 
there  is  one  record  for  each  of  the  12 
(in  this  case)  types  of  systems  in  the 
category  (tanks)  for  the  blue  force. 

-RECORD  45-46 
Blank 

-RECORD  47-58- 

These  twelve  records  have  data  for 
the  6  deployment  status  (columns) 
for  the  category  3  weapon  system  items 
(light  armored  vehicles);  there  is  one 
record  for  each  of  the  twelve  types 
of  the  systems  in  the  category  for  the 
blue  force. 


-RECORD  59-60- 
Blank 

-RECORD  61-65- 

These  five  records  have  data  for 
the  six  deployment  status  (columns) 
for  the  category  4  items  (helicopters); 
there  is  one  record  for  each  of  the  5 
types  of  the  systems  in  the  category 
for  the  blue  force. 

-RECORD  66-67- 

Blank 

-RECORD  68-70- 

These  twelve  records  have  data  for 
the  six  deployment  status  (columns) 
for  the  category  5  items  (anti-tank 
systems  and  mortars);  there  is  one 
record  for  each  of  the  1 2  types  of 


T 


systems  in  the  category  for  the 
blue  force. 

-RECORD  80-81- 
Blank 

-RECORD  82-89- 

These  eight  records  have  data  for  the  Free-F 

six  deployment  status  (columns)  for 

the  category  6  items  (artillery); 

there  is  one  record  for  each  of  the 

eight  types  of  systems  in  the  category 

for  the  blue  force. 

-RECORD  90-97- 
Blank 


-RECORD  98- 


1-9 

The  sum  of  blue  personnel  engaged 
in  engagement  type  1 

F  9.1 

10-18 

The  sum  of  blue  personnel  that  are 

K-kills  in  engagement  type  1 

F  9.1 

19-27 

The  sum  of  blue  personnel  that 
are  M-kills  in  engagement  type  1 

F  9.1 

-RECORD  99- 

1-108 

The  sum  of  blue  tanks  of  each 
type  1  thru  4  that  are  engaged,  K-kills 
and  M-kills  in  engagement  type  1 

12  (F  9.1) 

-RECORD  100- 

1-108 

The  sum  of  blue  tanks  of  each  type 

5  thru  8  that  are  engaged,  K-kills, and 

M-kills  in  engagement  type  1 

12  (F9.1) 

-RECORD  101- 

1-108 

The  sum  of  biue  tanks  of  each  type 

9  thru  12  that  are  engaged  K-kills, 
and  M-kills  in  engagement  type  1 

12  (F9.1) 
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-RECORD  102- 

1-108  The  sum  of  blue  APC's  of  each  type 
1  thru  4  that  are  engaged,  K-kills 
and  M-kills  in  engagement  type  1 

-RECORD  103- 

1-108  The  sum  of  blue  A  PC's  of  each  type 

5  thru  8  that  are  engaged,  K-kills,  and 
M-kills  in  engagement  type  1 

-RECORD  104- 

1-108  The  sum  of  blue  APC's  of  each  type  9 
thru  12  that  are  engaged,  K-kills,  and 
M-kills  in  engagement  type  1. 

-RECORD  105- 

1-108  The  sum  of  blue  helicopters  of  type 
1-4  that  are  engaged,  K-kills  and 
M-kills  in  engagement  type  1. 

-RECORD  106- 

1-27  The  sum  of  blue  helicopters  of  type 
5  that  are  engaged,  K-kills  and 
M-kills  in  engagement  type  1 

-RECORD  107- 

1-108  The  sum  of  blue  anti-tank  and  mortar 

systems  1  thru  4  that  are  engaged,  K-kills 
and  M-kills  in  engagement  type  1 

-RECORD  108- 

1-108  The  sum  of  blue  anti-tank  and  mortar 
systems  of  type  5-8  that  are  engaged, 
K-kills  and  M-kills  in  engagement  type  1 

-RECORD  109- 

1-108  The  sum  of  blue  anti-tank  and  mortar 

systems  9  thru  12  that  are  engaged,  K-kills, 
and  M-kills  in  engagement  type  1 

-RECORD  110- 

1-108  The  sum  of  blue  artillery  systems 

type  1  thru  4  that  are  engaged,  K-kilis 
and  M-kills  in  engagement  type  1 


12  (F9.1) 


12  (F9.1) 


12  (F9.1) 


12  (F9.1) 


3  (F9.1) 


12  (F9.1) 


12  (F9.1) 


12  (F9.1) 


12  (F9.1) 
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-RECORD  111- 


1-108  The  sum  of  blue  artillery  systems  12  (F9.1) 

of  type  5  thru  8  that  are  engaged, 

K-kills  and  M-kiils  in  engagement  type  1 

-RECORD  112- 


1-9 

The  sum  of  red  personnel  losses 
in  engagement  type  1 

F9.1 

11-18 

The  sum  of  red  tanks  losses  in 
engagement  type  1 

F9.1 

19-27 

The  sum  of  red  ICVs  losses  in 
engagement  type  1 

F9.1 

28-36 

The  sum  of  red  A  PC  losses  in 
engagement  type  1 

F9.1 

37-45 

The  sum  of  red  A  PC  and  ICV  losses 
in  engagement  type  1 

F9.1 

46-54 

The  sum  of  red  armor  losses  in 
in  engagement  type  1 

F9.1 

-RECORD  113  -  127- 


Repeat  of  the  above 
format  with  15  records 
constituting  data  for 
engagement  type  2 

-RECORDS  128  -  EOF 

Repeat  of  the  format  in  records  98  -  112 
with  groupings  of  15  records  for  engagement 
types  3  through  8. 

1.7  PERFORMANCE.  In  order  for  the  Ammo  Buffer  to  execute  successfully 
the  following  system  resources  will  be  required. 

CORE:  55,000  words  (55K)  main  memory 

CPU  TIME:  3  1/2  minutes 

CLOCK  TIME:  15  minutes 

PERIPHERAL  DEVICES:  5  -  assigned  space  1000  tracks 

2  -  assigned  space  128  tracks  (default) 


-RECORDS  128  -  EOF 


Repeat  of  the  format  in  records  98  -  112 
with  groupings  of  15  records  for  engagement 
types  3  through  8. 

1.7  PERFORMANCE.  In  order  for  the  Ammo  Buffer  to  execute  successfully 
the  following  system  resources  will  be  required. 

CORE:  55,000  words  (55K)  main  memory 

CPU  TIME:  3  1/2  minutes 

CLOCK  TIME:  15  minutes 

PERIPHERAL  DEVICES:  5  -  assigned  space  1000  tracks 

2  -  assigned  space  128  tracks  (default) 

COMMENTS:  This  program  is  normally  submitted 

as  a  batch  run  from  the  computer  terminal. 

ERROR  DIAGNOSTICS:  There  are  no  explicit  error  routines  or 

debugging  statements  written  into  this 
utility.  In  event  of  system  error,  program 
error  or  data  error  the  user  must  examine 
the  run  output  to  determine  the  error 
source  and  then,  systematically  trace 
through  possible  causes  to  determine  the 
fault. 
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losses  during  day  i 

BLUE  TOTAL 

73EUR0PE68. 

RUN  EM65 

0S0CCS1 

•UNCLASSIFIED* 

BLUE  CATEGORY 

LOST 

tanas 

APC  S 

LOSSES  OF  SIDE  BLUE 

RED  CATEGORY  CAUSING  LOSS 

AT/M  MELOS  ARTY 

CAS 

TANAS  <PERM| 

•TEMPI 

169.83 

103.96 

33.80 

21.6? 

9.05 

5.11 

111.00 

76.90 

4.77 

34.97 

90.70 

42.68 

APC  IPERMI 

•TEMPI 
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299.72 

43.17 
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3.77 

14.45 

10.08 

36.94 

13.60 

78.04 

68.30 

152.03 

•  T/H 

57.20 

190.84 

7.11 

6.11 

424.81 

19.11 

personnel  (1NCLU0ES 

MO  ST  M  1 0. 

t  R.T.D 

•  l: 

CREW 

908.58 

302.85 

99  .SI 

366.73 

167.27 

470.48 

HELO  CREW 

NONCRU 
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9  7  .09 

99S1.0I 

203.27 

ARTILLERY 

.00 

.00 

.00 
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CHAPTER  2 


EQUIVALENT  STYLIZED  DAY  PROGRAM 


2.1  DESCRIPTION:  The  purpose  of  the  Equivalent  Stylized  Day  (ESD)  program 
is  to  compute  the  equivalent  stylized  days  values  and  to  produce  the 
AMMOUT  file,  also  referred  to  as  the  TRM  output,  using  the  AMMOIN  data 
file  supplied  by  the  Ammo  Buffer  and  the  RPERCK  and  RSTYLO  data  files 
maintained  by  the  combat  analyst.  The  AMMOUT  file  is,  in  turn,  used  as 
one  of  the  major  inputs  to  the  final  program  of  the  APP,  the  Report 
Generator.  The  ESD  program  is  written  in  the  S1MSCR1PT  II. 5  programming 
language. 

2.2  STRUCTURE:  The  overall  structure  for  the  ESD  program  is  depicted  in 
Figure  III.2. 1.  The  number  at  the  upper  left  corner  of  the  file  symbol 
deno'  s  the  logical  unit  used  during  program  execution;  the  number  at  the 
lowe.  eft  corner,  interior,  is  the  order  of  data  utilization  by  the  program. 

2.3  DATA  BASE:  The  ESD  program  uses  three  files  for  input  and  produces  one 
main  output  file  and  one  print  file  as  its  output.  The  files  are  maintained  in 
sequential  order  on  mass  storage  devices.  Each  file  will  be  discussed  in 
more  detail  in  the  following  INPUT  and  OUTPUT  paragraphs.  These  files 
are  not  part  of  a  formal  database  structure. 

2.4  RUNSTREAM:  Figure  III.2.2  depicts  the  runstream  which  is  typically  used 
to  control  the  execution  of  the  ESD  program.  The  runstream  is  cataloged  as 
a  "START"  file  element  and  is  executed  by  submitting  the  job  as  a  batch  run 
from  the  terminal.  In  so  doing,  the  following  functions  are  accomplished: 

o  The  appropriate  run  is  activated  and  run  information  is  supplied  to  the 
system. 

o  The  AMMOUT  output  file  is  assigned  to  the  program,  run,  and  assigned 
to  logical  unit  9. 

o  The  AMMOIN  input  data  file  is  assigned  to  the  program  run,  and  will  be 
(d  ADD,'d  to  the  execution. 

o  The  RPERCK  file  is  conditionally  (if  present)  deleted,  a  new  file,  space 
is  allocated  and  set  to  the  value  of  "P"  via  the  (3USE  command.  The 
current  data  file  for  RPERCK,  version  V,  residing  as  an  element  in  the 
ESDGEN  program  file  is  edited  into  the  "P"  file.  "P"  is  set  for  input  on 
logical  unit  16. 

o  The  RSTYLO  file  is  conditionally  (if  present)  deleted,  a  new  file  and 
space  is  allocated,  and  set  to  the  value  of  "S"  via  the  (d  USE  command. 
The  current  data  file  for  RSTYLO,  version  V,  residing  as  an  element  in 
the  ESDGEN  program  file  is  edited  into  the  "S"  file.  "S"  is  set  for  input 
on  logical  unit  17. 
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o 


The  APPPRINT  output  file  is  unconditionally  (if  present)  deleted,  and  a 
new  file  and  space  of  1600  tracks  is  allocated  to  the  run.  The  value  of 
the  file  is  set  to  "A"  via  the  @  USE  command. 


o  The  "A"  or  APPPRINT  file  is  breakpointed  to  capture  the  program 
execution  and  selected  output  statements. 

o  The  ESD  program  object  code  (ABS2)  is  executed  and  the  AMMOIN  data 
added  to  the  runstream  (logical  unit  5). 

o  The  "A"  or  APPPRINT  file  which  has  been  breakpointed,  is  closed. 

o  The  AMMOUT  output  data  file  is  edited  via  a  change  command  to 

replace  all  occurances  of  the  scientific  notation  for  zero  (E+0*)  to  zero. 

o  The  first  and  last  25  lines  of  the  AMMOUT  file  are  printed  onto  the 
program  runstream. 

o  The  breakpointed  file  "A"  or  APPPRINT  is  edited  and  the  first  fifty 
lines  of  the  file  is  printed  onto  the  program  execution  runstream. 

o  The  run  is  terminated  on  the  system. 


2.5  INPUT:  The  ESD  program  uses  three  input  files.  One  file,  *-"-AMMOIN,  is 
produced  by  the  Ammo  Buffer,  the  remaining  two  files,  RPERCK.  and 
RSTVLO,  are  manually  created  and  maintained  by  the  combat  analyst.  Each 
file  is  discussed  below. 

o  AMMOIN  -  This  file  contains  study  control  information  provided  by  the 
combat  analyst  and  logistic  and  loss  data  obtained  from  the  Concepts 
Evaluation  Model  (CEM).  A  layout  is  as  follows  and  example  of  the  file 
can  be  seen  in  Figure  III. 2.3.  A  full  discussion  of  the  data  is  in  Chapter 
1. 


FILE:  ** AMMOIN 

STORAGE  MEDIUM:  Mass  Storage  -  Cataloged  file  in  Standard  Data 
Format  (SDF) 

SOURCE:  -  Output  produced  by  the  Ammunition  Buffer  Program. 


RECORD  LAYOUT 

POSITION 

DESCRIPTION 

FORMAT 

-RECORD  1- 

1-1  - 

Number  of  Blue  Weapon 
systems  modeled 

113 

14-26 

Number  of  Red  Weapon 
systems  modeled 

113 
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rr 


27-39 

Number  of  Postures  or  Samples 
in  the  APP 

113 

40-52 

Number  of  Equivalent  Stylized 

Days  (ESD's) 

113 

53-65 

Number  of  postures  or  samples 
in  the  CEM 

113 

-RECORD  2,  3- 

(Record  type  occurs  twice;  once  for  Blue  and  once  for  Red) 

1-13 

Max  number  of  types  of 
troops  played 

113 

14-26 

Max  number  of  types  of  tanks 
played 

113 

27-39 

Max  number  of  types  of 
light  armored  vehicles  played 

113 

40-52 

Max  number  of  types  of 
helicopters  played 

113 

53-65 

Max  number  of  types  of 
anti-tank  and  morter  systems  played 

66-78 

Max  number  of  types  artillery 
systems  played 

113 

-RECORD  4,  5,  6,  7,  8,  9- 


These  records  are  written  using  a  free  formating  option.  Therefore, 
positioning  is  critical,  as  significant  elements  are  simply  separated  by  at 
least  one  space.  In  this  case,  the  maximum  of  30  equipment  types  of  the 
Blue  force  that  are  being  played  are  identified.  A  CEM  number  of  "99" 
indicates  that  an  equipment  item  is  not  being  modeled  or  played. 

-RECORD  10,  11 

Same  as  records  4  through  9  except  this  record  type  is  used  to  identify  the 
six  Red  weapon  (equipment)  types  modeled. 

-RECORD  12 

Free  format  read  of  the  red  APP  mapping  numbers,  normally  equal  to  the 
numbers,  in  order,  on  records  10  and  11. 


57 


-RECORD  13  -  28- 


First  -  Each  record  contains  stylized  I 

fourth  quantity  data  for  each  sample 

(4  columns)  for  each  blue  system 
(total  16) 

-RECORD  29- 

First  The  total  number  of  days  of  I 

combat  modeled. 

-RECORD  30- 

Data  for  category  1  equipment  (personnel) 


First  Deployed  quantity  -  blue  Decimal 

Second  Replacements  to  pool  -  blue  Decimal 

Third  Returned  to  duty  -  blue  Decimal 

Fourth  Returned  to  pool  -  blue  Decimal 

Fifth  Replacement  to  stock  -  blue  Decimal 

Sixth  Surviving  assets  -  blue  Decimal 


-RECORD  33  -  39- 

This  series  of  records  details  for  each  CEM  type  (Weapon  Number)  of 
the  remaining  five  major  types  of  equipment  (i.e.,  tanks,  APC's, 
helicopters,  ATM's  and  artillery)  six  elements  of  data.  These  elements 
are: 


oo  Total  quantity  deployed; 

oo  Total  quantity  replaced  to  theater; 

oo  Total  quantity  returned  to  duty; 

oo  Total  quantity  repaired  and  issued  from  the  pool; 

oo  Total  quantity  returned  to  the  pool  from  maintenance; 

oo  Total  quantity  surviving  at  the  end  of  the  simulated  combat 
period  (180  days). 


RPERCK  -  This  file  details,  for  each  of  the  maximum  of  30  Blue  types 
of  equipment,  the  percentage  of  K-kill  to  M-kill  losses  inflicted  upon 


the  first  four  major  types  of  Red  targets  (i.e.,  personnel,  tanks,  ICV's 
and  APC's).  There  will  be  a  maximum  of  120  records  in  this  file.  The 
first  30  records  will  detail  the  percentage  of  losses  inflicted  by  the  30 
Blue  types  of  equipment  on  red  personnel;  the  second  30  will  detail  the 
percentage  of  losses  inflicted  on  red  tanks;  the  third  by  ICV's;  and  the 
fourth,  by  APC's.  Each  record  will  have  two  elements.  The  first 
element  identifies  the  Blue  equipment;  the  second  identifies  the 
percentage  killed.  A  percentage  of  99.9  indicates  to  the  program  that 
the  blue  weapon  was  not  played.  The  data  is  input  via  free-format  read 
statements.  An  example  of  this  file  is  depicted  in  Figure  111.2.4.  The 
record  format  is  as  follows: 

FILE:  PF.RPERCK 

STORAGE  MEDIUM:  Mass  Storage  Device 

SOURCE:  Input  file  cataloged  and  manually  created  by  analysts. 
RECORD  FORMAT: 

POSITION  DESCRIPTION  FIELD  FORMAT 


1-6 

Skipped  (blank) 

S6 

7-8 

Blue  weapon  identification 

12 

number 

9-12 

Percent  loss  to  a  red 

D(4,l) 

weapon  system 

RSTYLO  -  This  is  the  third  input  file  used  by  the  ESD  program  and  the 
other  file  which  is  manually  maintained  by  the  combat  analyst.  The  file 
contains  data  on  Red  losses  caused  by  specific  Blue  weapons  expressed 
not  as  percentages,  but  as  absolute  losses.  The  file  is  organized  into 
four  groups  of  four  element  records;  one  group  of  records  for  each  of 
the  four  major  Red  combat  weapons;  and  in  each  record  one  element  for 
each  of  the  four  combat  postures  played  in  the  Ammo  Post-processor. 
The  fifth  and  sixth  Red  weapon  loss  groups  are  calculated  by  the 
programs.  Red  equipment  5  stylized  losses  of  blue  items  are  computed 
as  the  sum  of  the  stylized  losses  for  equipment  3  and  4.  Red  equipment 
6  stylized  losses  of  blue  items  are  computed  as  the  sum  of  stylized 
losses  for  equipment  2  and  5.  In  each  Red  loss  record  group  there  will 
be  one  record  for  each  of  the  Blue  weapons  being  played  by  the  APP, 
less  those  weapons,  red  versus  blue  that  had  a  perecent  kill  of  99.9  as 
input  in  the  preceeding  "RPERCK"  file.  The  analyst  must  input  data  to 
match.  For  example,  in  lines  1  through  30  of  the  "RPERCK"  file  eleven 
(11)  equipment  items  have  a  value  other  than  99.9.  Therefore,  there  are 
11  records  of  data  (records  1  through  11)  with  each  record  containing 
the  stylized  losses  (4)  in  the  RSTYLO  data  file  (one  value  for  each 
sample).  Figure  III.2.5  depicts  a  typical  RSTYLO  file.  The  record 
format  is  as  follows: 
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FILE;  PF.RSTYLO 

STORAGE  MEDIUM;  Mass  Storage  Device 

SOURCE:  Input  file  cataloged  and  manually  created  by  the  analyst. 
RECORD  FORMAT: 


POSITION 

DESCRIPTION  FIELD  FORMAT 

1-6 

Skipped  (blank) 

S6 

Data  point  1 

Red  equipment  (tanks) 
stylized  to  Blue  Weapon 

Decimal 

Data  point  2 

Red  equipment  (APC) 
stylized  loss  to  Blue 

Decimal 

Data  point  3 

Red  equipment  (AM) 
stylized  loss  to  Blue  Weapons 

Decimal 

Data  point  4 

Red  Equipment  (Helicopter) 
stylized  loss  to  Blue  Weapons 

Decimal 

2.6  OUTPUT.  The  ESD  program  produces  two  output  files  —  the  **APPPRINT 
and  the  *"*AMMOUT  files.  The  **APPPRINT  file  is  a  print  file  which  tracks 
the  progress  of  the  program  and  writes  out  resulting  data  at  strategic  points 
in  the  processing.  For  example,  the  user  can  see  the  last  column  read  for 
the  6th  Red  Weapon,  from  the  **AMMO!N  file,  the  stylized  quantities  read 
for  Blue  weapons  and  postures,  etc.  A  sample  of  this  output  file  is  depicted 
in  Figure  III.2.6,  and  is  also  discussed  in  Chapter  3,  paragraph  3.5. 

o  **AMMOUT  file  -  The  second  output  file  produced  by  this  program  is 
the  **AMMOUT  file.  This  is  the  major  product  of  this  program.  This 
file  consists  of  a  series  of  groups  of  38  records  (normally).  There  will 
be  one  group  of  records  for  each  day  of  the  simulated  conflict.  The 
quantity  of  records  is  based  upon  the  number  of  samples.  (There  are 
four  sample*'  in  this  example).  For  example,  if  the  conflict  lasts  180 
days  there  will  be  180  groups  of  38  records  or  6,840  records  in  the 
entire  file.  Each  group  of  records  follows  the  format  specified  as 
follows.  An  example  of  the  file  is  depicted  in  Figure  111.2.7.  Each 
record  is  positioned  in  content  based  upon  the  total  systems  modeled  (in 
this  case  30  blue,  6  red). 

FILE;  **AMMOUT 

STORAGE  MEDIUM;  Mass  Storage  -  Disk  Resident 
SOURCE:  OutpuTTile  cataloged  and  created  by  the  program. 

RECORD  FORMAT; 
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POSITION 


DESCRIPTION 


FIELD  FORMAT 


1-15 

1-15 

1-15 

1-15 

1-15 

1-15 

1-15 

1  -  15 

1-15 

1-20 


-RECORDS  1,  2- 

Blue  weapon  deployment 

-RECORDS  3,  4- 

Blue  weapon  replacement 

-RECORDS  5,  6- 

Blue  weapons  returned  to 
duty 


-RECORDS  7,  8- 

Blue  weapons  replacement 
pool 


-RECORDS  9,  10- 

Blue  weapon  returned  to 
replacement  pool 

-RECORDS  1 1  -  12- 

Blue  weapon  surviving  assets 

-RECORDS  13-14 

Duplicate  records  of  11  and  12 

-RECORDS  15  -  22- 

Blue  weapon  K-kills  by 
sample  (4  each) 

-RECORDS  23-30- 

Blue  weapon  M-kiils  by 
sample  (4  each) 

-RECORD  31-38- 

Equipment  per  stylized 
day  and  sample  (each 
record  is  20  ESD's,  2 
records  are  one  sample. 


15  D  (8,1) 

15  D  (8,  1) 

15  D  (8,1) 

15  D  (8,1) 

15  D  (8,1) 

15  D  (8,1) 

15  D  (8,1) 

15  D  (8,1) 

15  D  (8,1) 

20  D  (5,2) 
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2.7 


1 


PERFORMANCE.  In  order  for  the  ESD  program  to  execute  successfully, 
the  following  system  resources  must  be  allocated: 


CORE:  24,000  words  (24K)  main  memory 

CPU  TIME:  3  minutes 


CLOCK  TIME:  18  minutes 

PERIPHERAL  DEVICES:  2  -  assigned  space  128  tracks  (default) 

1  -  assigned  space  1600  tracks 

COMMENTS:  This  program  is  normally  submitted  as  a 

batch  (mode)  program  from  the  users 
demand  (mode)  terminal. 


ERROR  DIAGNOSTICS:  There  are  no  explicit  error  handling 

routines  built  into  the  ESD  program. 
However,  the  APPRINT  file  produced  by 
the  program  contains  information  taken 
from  strategic  points  during  the  execution 
of  the  program.  If  problems  do  arise,  this 
file  can  be  used  to  help  trouble-shoot  the 
problems  and  provide  an  analysis  of  the 
data  as  it  flowed  through  the  program. 
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033  0330000  30030  0330303  0  0  0  0  3  0000033  03030  000030: 


333  3330333  33300  3330300  33303  3033033  00300  0030303 


030  0033333  30330  3300303  *30003  0003333  03300  3000000 


033  0333303  33300  003: 


OOOOO  0003000  03300  0030003 


003  0333000  OOOOO  0000030  OOOOO  OOQOOOO  00030  0000030 


033  3333303  33030  0300300  OOOOO  3  3  3  3  3  3  3  33333  3333033 


0333  0030303  003000  0000030  033303  0300003  033030  0030000 


0333  0303333  3333  0  3  3333333  333330  3033333  333333  3'.  33  -33 


0300  0030000  030000  0300000  033000  0000003  303300  0033030 


033333330303333303033333030033030333030333333333303300030 


0000000000000030o000000333a003300000333333330000030003033 


033  303303333 


33003333303333333300  33300303000 
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CHAPTER  3 


REPORT  GENERATOR  PROGRAM 

3.1  DESCRIPTION:  The  purpose  of  this  program  is  to  bring  together  data 
produced  by  earlier  programs  and  data  maintained  or  supplied  by  the  combat 
analyst,  and  produce  the  three  final  Ammunition  Reports  (i.e.,  Main  Report, 
Three  Day  File  Report  and  the  Distribution  of  Requirements  Report).  This 
report  details,  for  each  type  of  munition,  the  total  quantity  lost  or  expended 
during  the  simulated  combat  period.  The  program  is  implemented  in 
FORTRAN  IV  and  consists  of  one  routine. 

The  Report  Generator  computes  ammunition  requirements  for  four  main 
consumption  categories: 

First,  the  quantity  of  munitions  expended  through  weapon  system  zeroing  or 
calibration.  The  movement  of  each  system  within  the  theater  of  operations 
is  depicted  in  Figure  111.3. 1. A;  the  quantities  of  weapon  systems  that  move 
through  the  deployment,  replacement  and  repair  system  are  outputs  from 
CEM.  The  quantity  of  munitions  required  to  calibrate  a  weapon  system  is  an 
input  made  by  the  user/analyst. 

Second,  the  quantity  of  munitions  consumed  through  equipment  loss  or  on¬ 
board  losses.  This  includes  losses  of  combat  weapon  systems  (equipment 
types)  such  as  tanks  and  armored  personnel  carriers.  The  calculated  amount 
is  based  upon  weapon  system  K-kills  and  average  values  of  on-board 
quantities  (basic  load)  less  amounts  of  the  munition  fired  prior  to  the  weapon 
system  (equipment)  loss. 

Third,  the  quantity  of  munitions  expended  while  engaged  based  upon  stylized 
values  multiplied  by  previously  computed  Equivalent  Stylized  Days. 

Fourth,  the  quantity  of  munitions  destroyed  in  the  logistic  system  either  by 
loss  at  sea  or  within  the  theater  logistic  network. 

3.2  STRUCTURE:  Figure  111.3.1  presents  the  overall  structure  of  the  Report 
Program.  The  numbers  at  the  upper  left  corner  denote  the  logical  unit  used 
for  input  or  output.  The  interior  number  denotes  the  order  of  input  to  the 
program.  Transparent  to  the  user  is  the  preparation  of  the  Distribution 
Requirement  Report  and  the  3  -  Day  Report;  these  are  produced  and  copied 
into  the  output  file  REPORT1  by  the  program,  and  is  not  a  part  of  the 
runstream. 

3.2. A  Distribution  of  Ammunition  Requirements  -  The  report  generator  program 
incorporates  logic  to  include  two  significant  sources  of  ammunition 
expenditures  that  are  not  directly  related  to  target  engagement,  but  impact 
upon  the  total  ammunition  requirement.  These  factors  are  ammunition 
expenditures  for  weapon  zeroing  and  testing  in  the  theater  of  operations, 
and  at-sea  losses  or  losses  in  transit  to  the  theater  of  operations.  The  sea 
losses  c.re  historical  factors  as  are  the  zeroing  expenditures  by  weapon,  by 
time  period.  The  ammunition  expenditure  factors  for  each  of  the  seven  time 


periods  for  each  weapon  provides  a  distribution  as  follows,  where  in  the  time 
periods  are: 


1  :D-day  thru  day  1 5 

2  :Day  16  thru  day  30 

3  :Day  31  thru  day  60 

4  :Day  61  thru  day  90 

5  :Day  91  thru  day  120 

6  :Day  121  thru  day  150 

7  :Day  151  thru  day  180 

and  per  each  time  period,  the  requirement  factors  are: 

1  -.Initial  (basic)  amount 

2  :Combat  losses  in  a  Delay  mission  (DE) 

3  :Combat  losses  in  a  Defense  Intense  (DI)  mission 

4  :Combat  losses  in  a  Defense  Light  (DL)  mission 

5  :Combat  losses  in  a  Attack  (AT)  mission 

6  :Zeroing  requirements  on  initial  deployment 

7  :Zeroing  requirements  on  return  to  duty  at  the  unit 

8  :Zeroing  requirements  by  replacements  from  pool  to  unit 

9  :Zeroing  requirements  by  replacements  to  pool 

10  :Combat  firing  in  the  delay  mission 

1 1  :Combat  firing  in  the  defense  intense  mission 

12  :Combat  firing  in  the  defense  light  (static)  mission 

13  :Combat  firing  in  the  attack  mission 

14  :Harassment  and  Interdiction  (H  <5c  I)  firing 

15  :Logistic  losses  in  theater 

16  :Losses  in  transit  at  sea 

3.2.B  Ammunition  Expenditure  Computations  -  Two  methods  may  be  employed  by 
the  combat  analyst.  The  selection  of  the  computation  method  is  based  upon 
the  munitions  (card  type  3)  of  the  Ammunition  Expenditure  Data  (PF.  Data) 
file  for  the  specific  weapon  system. 

Normal  or  Pile  computation  method:  this  method  causes  the  3-day 
ammunition  expenditures  (only)  or  the  3-day  "piles"  to  be  computed  followed 
by  the  rates  computations. 

3  -  Day  Pile  (Period)  =  zeroing  requirement  (period) 

+  stylized  expenditures  (period) 

Before  proceed1  ng  into  the  rates  computations  the  sea  losses  (period)  are 
computed  and  cdded  to  the  3  -  Day  Pile  (period). 

Rate  computation:  The  rates  computation  may  be  entered  following  the  3  - 
day  pile  computation  above,  or  entered  into  directly. 

Rate  (period)  =  Rounds  Expended  (period) _ _ 

Average  Deployment  (period)  x  Days  (Period) 
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3.3  DATA  BASE:  The  data  base  which  is  used  to  support  this  program  consists 
of  four  input  files  and  four  output  products.  The  files  are  not  part  of  one 
formal  database,  but  maintained  as  seperate  files  by  the  analyst.  The  input 
files  consist  of  the  AMMOUT  file  which  was  produced  by  the  ESD  program, 
the  TITLE  file  which  is  created  by  the  combat  analyst  and  includes 
identification  data  for  the  three  reports  generated  by  the  program,  the 
Sample  Day  Input  file  (also  referred  to  as  ISD)  which  denotes  for  each  day  in 
the  study  the  number  of  samples  or  postures  that  are  being  played,  and  the 
AMMO  (or  DATA)  expenditure  file.  The  main  output  file  **REPORTl  is 
partitioned  into  3  reports  as  explained  below;  the  fourth  file  is  prepared  for 
subsequent  copying  onto  tape. 

3.4  RUNSTREAM:  Figure  III.3.2  depicts  the  runstream  that  is  used  to  control 
the  execution  of  the  REPORT  program.  The  runstream  is  cataloged  by  the 
user  as  a  "START"  file  element.  Execution,  or  job  submission  is  made  by 
submitting  this  as  a  batch  run  from  a  terminal.  As  the  runstream  is 
processed  it  accomplishes  the  following  functions: 

o  The  run  is  activated  and  submitted  to  the  operating  system; 

o  Program  file  (56ESDGEN)  which  contains  the  input  files  is  assigned; 

o  The  variable  name  "F."  is  to  be  used  instead  of  the  Program  File  name 

for  the  remainder  of  the  processing; 

o  The  old  output  file  REPORT1  (56REPORT)is  deleted 

o  The  input  file  (AMMOUT)  is  assigned  to  the  run. 

o  Output  file  SEVEN  is  assigned  and  will  use  logical  unit  7; 

o  Logical  units  3  and  2  are  assigned  to  be  used  as  temporary  files  to 

collect  output.  Unit  2  will  collect  the  Three  Day  File  report;  Unit  3 

will  contain  the  Distribution  of  Requirements  report; 

o  The  input  file  **AMMOUT  is  assigned  to  the  logical  unit  10; 

o  A  breakpoint  file  to  capture  the  run  output  (REPORT)  is  opened. 

o  These  input  data  files  are  printed  (@PRT,S)  and  captioned  in  the 
breakpoint  file. 

o  The  program  (REPORT86)  is  executed; 

o  Using  the  (9ADD  command  of  EXEC8,  three  input  files,  Sample  Day 
Input  (ISD),  Title,  and  Ammo  Exenditures  Input  (DATA),  are  inserted 
here  and  are  read  by  the  program  using  Logical  Unit  5; 

o  Using  the  system  editor,  100  lines  of  the  output  file  **SEVEN  and  input 
file  **AMMOUT  are  listed  with  line  numbers; 
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o  The  Breakpoint  file  established  is  closed,  released  from  the  program 
run,  and  sent  to  the  printer. 

3.5  INPUT.  The  REPORT  program  uses  four  files  as  its  input.  These  files  are 
the  **AMMOUT,  PF.ISD,  PF.TITLE,  and  PF.DATA.  Each  will  be  discussed 
below. 

o  "^AMMOUT  -  This  file  is  produced  by  the  ESD  program  which  must 
have  been  run  prior  to  this  program.  The  file  contains  data  describing 
Blue  assets  and  their  status  for  each  day  during  the  conflict.  The  file 
was  previously  known  as  the  TRM  (Theater  Rates  Model)  output  file, 
the  file  should  have  6840  lines  (records)  of  data  for  a  180  -day  conflict, 
with  38  lines  of  data  per  day.  The  file  contents  are  as  follows  and  an 
example  of  a  portion  of  the  file  is  found  in  Figure  III.  3. 3. 

In  the  first  30  lines,  15  sets  of  data  are  listed  in  two  line  pairs.  The  first 
line  is  for  blue  equipment  types  1  thru  15  and  the  second  line  is  blue 
equipment  types  16  thru  30: 

Lines  1  <5c  2:  BLUDEP  -  Blue  Deployments  to  the  Theater  Today 

Lines  3  &  4:  BREPA  -  Blue  Replacements  to  the  Theater  Today 

Lines  5  &  6:  BRTD  -  Blue  Returns  to  Duty  (from  lower  level 

maintenance)  today 

Lines  7  &  8:  BREPU  -  Blue  Replacements  (from  replacement  pool)  issued 
today 

Lines  9  &  10:  BRTR  -Blue  Returns  to  Replacement  pool  today  from 
higher  level  maintenance 

Lines  11  <5c  12:  BASS  -  Blue  Surviving  Assets  Today 

Lines  13  &  14:  BLUON  -  Blue  On  Line  Equipment  (committed)  today 

Lines  15  thru  22:  BXTT  -  number  of  blue  equipment  "K"  killed  today 
(non-repairable)  by  posture  -  2  lines  for  each  posture  (Delay,  Defense 
Intense,  Defense  Light,  and  Attack) 

Lines  23  thru  30:  BXMT  -  number  of  blue  equipment  "M"  killed 
(repairable)  today  by  posture  -  2  lines  for  each  posture  (Delay,  Defense 
Intense,  Defense  Light,  and  Attack) 

Lines  31  thru  38:  ESD  AY  -  daily  ESD  quantities  by  posture  as  above;  the 
first  line  has  ESD's  1  thru  20,  and  the  second  line  has  ESD's  21  thru  40. 

o  PF.ISD  -  This  file  element  is  maintained  and  created  by  the  Combat 
Anal>jt  and  is  used  to  provide  the  number  of  samples  or  combat 
postures  that  will  be  used  in  each  of  the  180  days  of  the  conflict.  Each 
record  in  the  file  will  contain  a  single  number  (i.e.,  a  1,  2,  3,  or  4)  in 
Column  2.  Figure  III. 3.4  presents  an  example  of  a  portion  of  the  files. 
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o  PF.TITLE  -  This  file  element  is  maintained  or  created  by  the  combat 
analyst.  This  file  supplies  to  the  program  the  titles  to  be  used  in  each 
of  the  three  reports  produced  by  the  program.  It  also  contains  data 
describing  sea  losses  suffered  by  Blue  forces  in  each  of  the  7  time 
periods  of  the  analysis.  Finally,  it  supplies  formating  data  to  the 
program  indicating  the  number  of  lines  per  page  for  each  report  and  the 
total  number  of  pages  in  each  report.  These  final  two  entries  will 
follow  the  format  of  312  or  three  entries  of  two  integers  each  and  will 
start  in  column  1.  Figure  III.2.5  presents  an  example  of  this  file. 

o  PF.DATA  -  This  file  is  also  manually  maintained  or  created  by  the 
Combat  Analyst.  It  is  also  referred  to  as  the  Ammo  Expenditures  Input 
file.  This  file  details  for  each  weapon  system  and  munition  combination 
such  data  as  identification  data,  deployment  data,  loss  data  and 
expenditure  data.  This  data  is  organized  into  6  card  types.  The  file 
format  is  described  as  follows  and  an  example  of  a  portion  of  the  file  is 
presented  in  Figure  III.  3. 6.  The  complete  file  would  typically  have 
approximately  700  lines  (records). 

FILE:  PF.DATA 

STORAGE  MEDIUM:  Mass  Storage,  disk  resident,  cataloged  as  an 
element  of  the  anlyst's  program  files. 

SOURCE:  Manually  produced  from  the  weapon  system  modeled  in 
COSAGE  and  CEM. 


POSITION  DESCRIPTION  FIELD  FORMAT 

Card  Type  1  -  weapon  card  -  one  required: 

I- 2  Card  Type  12 

3-42  Weapon  name  data  10A4 

Card  Type  2  -  Deployment  card  -  one  required;  the  quantity  deployed  in  each 
period: 

1-2 

3-10 

II- 18 
19-26 
27-34 
35-42 
43-50 


Card  Type 

12 

D-Day  (Dep(l)) 

F8.0 

1-15  (Dep(2)) 

F8.0 

16-30  (Dep(3)) 

F8.0 

31-60  (Dep(4)) 

F8.0 

61-90  (Dep(5)) 

F8.0 

91-120  (Dep  (6)) 

F8.0 

-otagHwsaai 
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51-58 

121-150  (Dep  (7)) 

F8.0 

59-66 

151-180  (Dep(8)) 

F8.0 

67 

Print  indicator  (1PRT) 

1  =  Do  not  print  deployment 

0  =  Print  deployment 

11 

Card  Type  3  - 

■  Munitions  card  -  one  required: 

1-2 

Card  Type 

12 

3-32 

Munition  name 

5A6 

33 

Business  round  indicator 

1  =  Business  round 

0  =  Nonbusiness  round 

11 

34 

Computation  method 

0  =  Normal  (pile)  method 

1  =  Use  the  rates  from  the 
factors  card  (rate  method) 

11 

41-50 

Weight  of  munition  in  pounds 

F10.0 

Immediately  following  each  type  3  card,  there  must  be  a 
containing  the  SSN  (Special  Study  Number)  and  all  LIN’s  (line 
numbers)  for  the  munition  identified  on  the  type  3  card. 

card 

item 

Card  type  4  -  Expenditures  per  time  period  factors  card.  This  is  either 
a  pile  or  rate  factor  for  the  period  -  one  required: 

1-2 

Card  Type 

12 

3-7 

Log  Loss  Factor,  Fac  (1) 

F5.0 

8-12 

H  &  I  factor,  Fac  (2) 

F5.0 

13 

Blank 

IX 

14-19 

Factor  (3),  days  1-15 

F6.0 

20 

Blank 

IX 

21-26 

Factor  (4),  days  16-30 

F6.0 

27 

Blank 

IX 

28-33 

Factor  (5),  days  31-60 

F6.0 
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35-40 

Factor  (6),  days  61-90 

F6.0 

41 

Blank 

IX 

42-47 

Factor  (7),  days  91-120 

F6.0 

48 

Blank 

IX 

49-54 

Factor  (8),  days  121-150 

F6.0 

55 

Blank 

IX 

56-61 

Factor  (9),  days  151-180 

F6.0 

62 

Blank 

IX 

63-67 

Scale  factor 

15 

Card  type  5  -  Stylized  losses  per  system,  per  posture  factor  card  zero  or 
more  required: 

1-2 

Card  Type 

12 

3-5 

Blank 

3X 

6-10 

System  number 

15 

11-20 

Stylized  losses  per  system 
-  DE 

FI  0.0 

21-30 

Stylized  losses  per  system 
-  DI 

FI  0.0 

31-40 

Stylized  losses  per  system 

-  dl 

FI  0.0 

41-50 

Stylized  lories  per  system 
-  AT 

FI  0.0 

51-60 

Zero  -  the  number  of  rounds 
to  zero 

FI  0.0 

Card  type  6 
required: 

-  Stylized  expenditure  per  posture  card 

-  one  to  fifty 

Card  Type 

6  or  99  Card  Type:  99  =  Last 


1-2 


12 


3-5 

Sample  number;  999, 
for  all  samples 

13 

6-10 

ESD  number 

15 

1 1-20 

Stylized  expenditure  -  DE 

FI  0.0 

21-30 

Stylized  expenditure  -  DI 

FI  0.0 

31-40 

Stylized  expenditure  -  DL 

FI  0.0 

41-50 

Stylized  expenditure  -  AT 

FI  0.0 

3.6  OUTPUT:  This  program  has  4  outputs;  three  reports  and  one  file  which  is 
forwarded  to  the  Office  of  the  Deputy  Chief  of  Staff,  Logistics  (DCSLOG). 
The  three  reports  are  the  **REPORTl,  Distribution  of  Requirements  (DRR) 
Report,  and  the  Three  Day  Piie  Report.  Each  will  be  described  below.  The 
user  should  note  that  when  output,  REPORT  1,  the  DRR  and  3  Day  Pile 
report  are  all  within  the  same  file. 

o  *-*SEVEN  -  This  data  file  which  is  written  to  unit  seven  (hence  the 
name)  which  eventually  is  written  to  magnetic  tape  for  shipping  to 
ODCSLOG.  The  file  contains  such  information  as  the  Special  Studv 
Number  (SSN),  list  of  weapons  and  munitions,  line  numbers  for  eacn 
munition,  and  the  rate  at  which  this  munition  is  being  consumed  during 
each  time  period.  The  format  for  this  file  is  depicted  in  Figure  III. 3.7 
and  the  file  is  labeled.  The  program  file  (mass  storage)  to  tape  copy  is 
not  a  part  of  the  program  runstream. 

o  REPORT  1  -  This  report  details  for  each  weapon/munitions  combination 
the  quantity  of  this  munition  deployed  and  consumed  for  each  time 
period  in  the  study.  An  example  of  the  report  is  found  in  Figure  III. 3.8 
and  the  report  is  labeled.  This  file  typically  produces  40  pages  (2200 
lines)  of  output. 

o  Distribution  of  Requirements  Report  -  This  second  report  details  for 
each  weapon/munition  combination,  for  each  time  period,  the  quantity 
of  the  munition  consumed.  This  quantity  is  further  broken  out  by  the 
reason  the  munition  was  consumed  (for  example,  quantity  lost  and 
expended  in  each  of  the  four  combat  postures,  quantity  used  in  zeroing 
the  weapon  at  each  stage  in  its  repair  or  deployment,  amount  lost  in 
transporting  by  sea,  etc..  An  example  of  the  report  is  presented  in 
Figure  111.3.9  and  the  report  is  labeled.  The  file  typicaly  consists  of 
approximately  66  pages  (3700  lines)  of  output. 

o  Thre'-  Day  Pile  Report  -  This  third  and  final  report  presents  for  each 
weapon/munition  combination  in  three  day  increments  the  quantity  of 
this  munition  that  this  weapon  will  require.  There  is  also  a  presentation 
of  munitions  issued  in  bulk  (e.g.,  small  arms  rounds,  summed  by  units  of 
1,000  troops).  Figure  III.  3. 10  presents  an  example  of  this  report  and  the 


report  is  labeled.  The  file  typically  consists  of  approximately  16  pages 
(900  lines)  of  output. 

3.7  PERFORMANCE:  This  program  historically  has  required  the  following 
resources  for  normal  program  execution  in  the  operating  system. 

CORE:  25,000  words  (25K)  main  memory 

CPU  TIME:  3  minutes 

CLOCK  TIME:  18  minutes 

DISK  UNITS  l  -  assigned  space  1000  tracks 

1  -  assigned  space  500  tracks 
1  -  assigned  space  200  tracks 
3  -  assigned  space  128  tracks  (default) 

COMMENTS:  The  program  is  normally  submitted  as  a 

batch  (mode)  program  from  the  demand 
terminal.  The  creation  of  the  **SEVEN 
tape  is  accomplished  by  the  user,  as  a 
seperate  function.  This  task  is  normally 
completed  at  the  computer  terminal  in  the 
demand  mode. 

ERROR  CONDITIONS:  Specific  error  statements  are  not  built  into 

the  program.  User's  must  examine  the  run 
output  to  perform  data  debugging  and 
source  level  debugging.  Refer  to  the 
programmers  maintenance  manual  and 
contact  the  maintenance  programmer  for 
additional  assistance. 
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Appendix  B 

Terms  and  Abbreviations 


Ammunition  Post  Processor  -  A  related  group  of  computer 
software  programs  that  is  a  part  of  the  WARRAMP  methodology; 
used  to  compute  the  expected  consumption  of  ammunition  of 
selected  calibres  of  a  force  in  a  conflict. 

Concepts  Evaluation  Model  -  A  low  resolution  theater  combat 
model  that  simulates  the  combat  between  two  opponent  forces 
over  a  specific  period  of  time  producing  force  results. 

Combat  Sample  Generator,  a  high  resolution  model  that  simulates 
tactical  combat  between  a  rev*  ml  blue  force;  a  production  model 
that  produces  force  on  fortes  v#  ©;Us. 

Equipment  Loss  Conscej£*t-sr 

Equivalent  Stylized  Day  Wartime)  combat  between  a  postured 
blue  and  red  fora??  used  o  provide  an  activity  comparison 
between  forces. 

Heavy  Materiel  Supply  !H">its  (Companies). 

Item  Identification  File. 

A  catastrophic  kill  of  the  item  (target)  rendering  it  incapable  of 
returning  fire  or  movement  and  is  non-repairable. 

Lethal  area  of  indirect  fire  (area  type)  weapon  systems. 

Logistics  Evaluation  Agency. 

Line  Item  Number  (Code)  -  LINCODE. 

Lines  of  Communications. 

Major  items  of  equipment. 

A  hit  on  an  item  (target)  that  renders  it  immobile,  but  repairable 
and  capable  of  returning  fire. 

Office  of  the  Deputy  Chief  of  Staff  (Army)  for  Operations. 
Probability  of  Kill. 

Red  Artillery  Model. 

Returned  To  Duty;  personnel  or  repaired  equipment. 


RTD 


SSPK 


Single  Shot  Probability  of  Kill. 

SRC  Standard  Requirements  Code. 

TAM  Target  Acquisition  Model. 

TOE  Table  of  Organization  and  Equipment. 

TRCONS  Theater  Rate  Consolidation  data  file. 


TRMAP 

TRM 


WARE 


WIMP 


Theater  Rate  Mapping  data  file. 

Theater  Rates  Model,  used  to  simulate  a  theater  conflict, 
generating  stylized  combat  periods;  used  to  compute  ammunition 
consumption  rates  for  several  weapon  -  munition  combinations. 

Wartime  Replacement  Factors,  also  known  as  Wartime  Active 
replacement  factors.  Rates  of  loss  or  specified  periods  or  time 
increments  for  selected  combat  materiel  items. 

WARF  Intermediate  Materiel  Processor. 
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